碍于篇幅，怕大家看不过来之后直接选择从入门到放弃，所以先把两个中长篇幅的“段落”发出来，本来视频、音频、字幕这几个章节应该放在同一篇当中的，但是看了一下字数，嗯，估摸着7W+字，两眼一黑，稳定发挥。。。本篇主讲第14.3章节（程序行为）至第14.5章节（视频）的文档说明。

这部分文档中的有些配置项还是值得去研究和尝试的，不过大多数还是保持默认就好。还有就是我很想吐槽几句原文的部分表述，我个人非常讨厌在使用手册中时不时地会来几句绕弯子的描述说明，本末倒置。所以偶尔遇到我在注释中吐槽的话还请大家见谅。

以下摘取自 mpv player 官方使用手册中的OPTION章节，版本 v0.34.0，不保证内容的时效性，仅供参考，实际还是以官方发布的最新文档为准，善用 Ctrl + F 快速定位你想要的内容：

2023/09/03 修订：

+ v0.35.1 版本新增 Ch.14.4 “稍后再看”的章节内容。

注：与其说是新增章节，实际是将“稍后再看”的选项说明，从 v0.34.0 的“程序行为”中分离出作为独立章节。

Ch.14.3 程序行为

--help, --h

显示简短的选项概括说明。

你还可以项该选项中传入一个字符串，将会列举出所有名称中包含该字符串的顶级选项帮助说明，例如，--h=scale 对应所有包含 scale 单词的（顶级）选项，特殊字符串 * 会列出全部的顶级选项说明。

注：有点类似于 ffmpeg 的 -h type=name 选项效果，如果在后面指定了需要检索的内容，则会返回这一类的选项帮助说明，比如说 ffmpeg -h encoder=h264

-v

增加（说明内容）详细级别，每个 -v 选项都能在命令行中找到对应的级别。

--version, -V

打印版本字符串信息并退出。

--no-config

不加载默认的配置文件，该选项用于阻止同时加载用户级别和系统范围的 mpv.conf 和 input.conf 文件，其他的配置文件也会被阻止加载，例如负责恢复播放的文件。

注意

那些通过命令行选项的方式明确被需要的（配置）文件，例如 --include 或者 --use-filedir-conf 选项，将仍然会被加载。

另见：--config-dir 选项说明。

--list-options

打印所有可用的选项。

--list-properties

打印可用的属性列表。

--list-protocols

打印受支持的协议列表。

--log-file=

打开给定的路径用于向其中写入和打印日志信息，已存在的文件将会被截断。日志级别至少是 -v 等级，不过可以通过 --msg-level 选项进行提升（该选项无法低于其自身强制的最低日志等级）

一个特殊的情形是 macOS 的捆绑包，默认会在 ~/Library/Logs/mpv.log 路径下创建日志文件。

--config-dir=

强制使用不同的配置目录。如果设置了该选项，给定的目录会被用来加载其中的配置文件，并且其他所有的配置目录都会被忽略，这也意味着全局的mpv配置目录连同每个用户的配置目录都会被忽略，以通过环境变量（MPV_HOME）进行覆盖的配置目录也会被忽略。

需要注意的是 --no-config 优先级高于该选项。

--save-position-on-quit

退出时总是保存当前播放位置，稍后再次播放该文件时，播放器会跳转到原先的播放位置开始播放，如果被播放的文件是通过退出以外的其他任何方式被终止的，那么上述的这种行为就不会发生。例如，当跳转到播放列表中的下一个文件的瞬间是不会保存当前播放位置，并且下次播放时只会在当前需要播放的文件开始。

这项行为默认是禁用的，但当你使用 Shift + Q 退出播放器时，该功能始终是可用的。

注：之前试着用过这项功能，感觉有点鸡肋，并没有想象中的那么智能，不知道最新版本有没有完善。

正常退出播放器时会将当前的播放位置、软件设置等信息保存到配置路径下的 watch_later 目录中（默认），生成一个以MD5值命名的配置文件。

不过当你加载相同的播放列表时，恰巧这个列表内容又很长，如果是图形界面用拖拽的方式播放，很难保证再次播放的首个文件就是之前退出时播放的文件。是的，这个退出保存功能只有在下次播放时恰好加载到之前退出的文件才起作用。

--watch-later-directory=

指定用于存储“稍后再看”临时文件的目录。

默认是配置目录（通常是 ~/.config/mpv/ ）下一个名为“watch_later”的子目录。

--dump-stats=

向给定文件中写入精确的统计信息，文件在打开时会被截断（如果原先就存在且有内容的话）。文件中会包含原始的样本数据，每项都带有一个时间戳。为了使该文件可读，可以使用 TOOLS/stats-conv.py 脚本（以图像的形式显现）。

该选项仅在调试时会有帮助。

注：这里的可读是相对于人来说的，使用脚本将原始内容处理并转化为人可以理解的信息。

--idle=

当没有文件可以播放时让mpv进入空闲等待而不是退出，在输入模式下会很有帮助，可以通过输入命令来控制mpv播放器（默认：no）

once 表示仅在软件启用时空闲等待，并且在首个播放列表播放完毕后让播放器自行关闭。

--include=

指定要在默认的配置文件之后解析的配置文件。

--load-scripts=

如果设置为 no，则不会自动从配置路径下的 scripts 子目录（通常是 ~/.config/mpv/scripts/ ）中加载脚本。（默认：yes）

--script=, --scripts=file1.lua:file2.lua:...

加载Lua脚本，第二个选项允许你通过使用路径分隔符（在Unix中是 : Windows下是 ; ）进行分隔的方式加载多个脚本文件。

--script 是一个路径列表选项，详情见 Ch.4.5 List Options 章节。

--script-opts=key1=value1,key2=value2,...

为脚本设置选项，可按照键值查询选项。如果对脚本使用了某个选项，则该选项具体有何语义完全取决于被加载的脚本，未被任何脚本声明过的选项值都会被忽略。

该选项是一个键值组合列表选项，详情见 Ch.4.5 List Options 章节。

--merge-files

假设将所有传给mpv的文件串联成单个大文件，在文件内容使用时间轴/EDL作支持。

--no-resume-playback

不要从配置路径下的 watch_later 子目录（通常是 ~/.config/mpv/watch_later/ ）的配置文件中恢复播放位置。参见 quit-watch-later 输入命令。

--resume-playback-check-mtime

仅在文件的修改时间与保存记录一致时，从 watch_later 目录下的配置文件中恢复播放位置。这可以防止在具有相同名称但内容不同的文件中错误地恢复播放进度。（默认：no）

--profile=

使用给定的配置文件，--profile=help 选项会显示当前已定义的配置文件列表。

--reset-on-next-file=

一般来说，mpv会在尝试播放列表中的下一个文件时继续保留当前所有的设置，即使这些设置在播放期间被用户修改过（该行为正好与 MPlayer 相反，后者尝试在播放下一个文件时重置所有的设置项）

默认：不要重置任何设置。

上述行为可以使用该选项做出更改，接受选项列表，并且mpv会在开始播放时将这些选项重置为初始值。初始值可以是默认值，或者是由配置文件、命令行（的选项值）进行设置。

在某些情况下，该选项可能不会如预期那样工作，比如说，--volume 选项只会在配置文件或命令行中被明确设置时才会重置。

特殊名称 all 会尽可能多的重置选项。

该选项是一个字符串列表选项，详情见 Ch.4.5 List Options 章节。

--watch-later-options=option1,option2,...

如果给定选项自从mpv开启之后被修改过的话，则会保存到"稍后再看"的文件中。这些值会在下次再次播放该文件时恢复。播放进度总是会以 start 选项的形式保存，因此将 start 添加到这个列表中是没效果的。

当移除选项时，已经存在的稍后再看数据是不会被修改的并且依旧会被完整地应用，不过新的稍后再看数据中将不再包含这些（被移除）的选项。

该选项是一个字符串列表选项，详情见 Ch.4.5 List Options 章节。

--write-filename-in-watch-later-config

采用自身指向的实际文件名作为稍后再看配置文件的命名，只是简单地在文件顶部写上注释。

注：简单来说就是用你播放过的文件名作为恢复播放状态记录文件的命名，而不是默认的MD5值。

警告

该选项可能会暴露个人隐私信息，因此默认是禁用的。

--ignore-path-in-watch-later-config

当使用稍后再看功能时忽略配置所在路径（也就是仅使用文件名）（默认：禁用）

--show-profile=

显示用户配置描述和内容，如果不指定参数则列出全部的用户配置。

--use-filedir-conf

在与被播放文件的相同目录下查找指定的配置文件，参见 Ch.5.4 File-specific Configuration Files 章节。

警告

如果播放的是未信任的媒体文件也许会有危险。

--ytdl, --no-ytdl

启用 youtube-dl 钩子脚本，查找输入的 URL 链接并播放位于网络中的视频。这项功能适用于众多直播等流媒体网站，而不仅仅是该脚本名称中所表示的网站（Youtube）

如果脚本无法对URL链接执行任何操作，那么将不执行任何操作。（搁这儿搁这儿呢？）

该脚本可接受一组选项，通过带上 --script-opts 选项就可以传入这些内容（使用 ytdl_hook- 作为选项前缀）

try_ytdl_first=

如果选择了 yes 将会首先尝试使用 youtube-dl 去解析 URL 链接，而不是默认的仅在mpv打开链接失败后再去用这个工具去解析。这主要取决于你的大多数链接是否都需要 youtube-dl 工具去解析。

exclude=